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Introduction 


This little manual is intended to be a constant com- 
panion of the Apple II? family of personal/business 
computers, including the Apple II +, the FRANKLIN 
ACE 1000", and the “look-a-like” ORANGE", and 
PINEAPPLE™. It is intended for use in creating 
programs and getting them running. 

Each index tab opens to a key word. The book 
includes all key words used by APPLE MI- 
CROSOFT BASIC"", For each key word, you are 
given: 


The Name, if different than the key word 
The Token used for internal storage 
The Class of instruction 

The required use Form 

The Conditions under which the key word 
should be used and the result of its use 


In addition, some entries give warnings and 
hints on the use of the key word. 


Appendices provide summary information on 
variables, delimiters, operators, and priorities plus 
various other data necessary or useful in program- 
ming, including DOS commands and machine- 
language operations codes. 

In preparing this material, the ultimate author- 
ity has been the Apple Il + computer itself, in 48K 
form with disk. The manufacturer's literature is the 
next level of authority, and general literature the 
last. All stated forms have been checked and are 
correct at the time of writing. 

The author, editor, and publisher would ap- 
preciate a note if you find any errors that may have 
crept in, indications of changes by the manufac- 
turer, or suggestions for making the volume more 
useful. 


Token (none) Name Ampersand 
& 


Class System and Utility 


& 


Conditions Intended for internal use; not a proper 
command. 


If used, causes an unconditional jump 
to location $3F5, then to $FF58. 


Use RESET to escape. 


Prints register contents. 


ABS 


Token 


Class 


Forms 


Conditions 


212 Name Absolute Value 


Mathematical Function 


ABS 


ABS (variable) 

ABS (expression) 

Applied to a variable or an expression, 
returns the absolute (positive only) 


value of the variable or expression. 


ABS has no meaning for string vari- 
ables or strings. 


Token 205 


Class Arithmetic Relational Operator 


AND 


Form Relation 1 AND relation 2 
Conditions The logical operator AND assumes the 
value true only if both relation 1 and 
relation 2 are true. 


May be combined with NOT, to give the 
AND NOT relation, or NAND. 


If both stated relations include NOT, the 
result is equivalent to OR. 


There may be multiple ANDs in an ex- 
pression. 


Has no meaning for string variables. 
A relation is true if nonzero. 
Truth table for AND 


X AND Y 
F 


а атт» 


Y 
F 
T = 
F = 
T T 


Token 


Class 


Forms 


Conditions 


230 Name Code 


Array and String Function 


ASC 


ASC (string variable) 

ASC (string expression) 

ASC (“string”) 

Returns the ASCII code of the first 
character of the variable, expression, or 


string. 


The string must be in quotes and must 
not be empty nor include quotes. 


The returned value may not be the low- 
est number for a given character. 


Has no meaning for numerics. 


Token 


Class 


Forms 


Conditions 


225 Name Arctangent 


Mathematical Function 


ATN 


ATN 
ATN (number) 


ATN (variable) 
ATN (expression) 


Returns the angle, in radians, whose 
tangent is equal to the specified value 
or the current value of a variable or ex- 
pression; integer values are converted 
to real values before evaluation. 


Returned values are in range —7/2 to 
+т/2 radians. 


ATN has no meaning for string quan- 
tities. 


Token 


Class 


Forms 


Conditions 


197 


Graphic and Game 


AT 


Low Resolution Graphics 


HLIN expression 1, expression 2 
AT expression 3 


VLIN expression 1, expression 2 
AT expression 3 


High Resolution Graphics 


DRAW expression 1 AT expres- 
sion 2, expression 3 


XDRAW expression 1 [AT expres- 
sion 2, expression 3] 


In low resolution graphics (GR), AT is 
used to specify the row (HLIN) or col- 
umn (VLIN) for which a line is to be 
drawn. 


In high resolution graphics (HGR), AT is 
used to specify the X, Y coordinates at 
which a shape (expression 1) is to be 
drawn. 


See HLIN, VLIN, DRAW, GR, HGR. 


The terms in brackets are optional. 
(See XDRAW). 


Token 


Class 


Form 


Conditions 


Note 


140 


System and Utility Command 


CALL 


CALL address 


Used to call a machine language 
routine starting at indicated address. 


CALL 


Address may be positive or negative 
and range from —65535 through 65535. 
It may be a variable or an expression. 


(CALL —936 = CALL 64600) 


Rules of 6502 machine language apply 
to called routines. 


A called routine should end with an RTS 
command. 


CALL —151 transfers control to the 
monitor. See Appendix K for other 
useful calls. 


Token 


Class 


Forms 


CHR$ 


Conditions 


231 Name Character 


Array and String Function 


CHR$ 


CHR$ (number) 
CHRS (variable) 
CHRS (expression) 


Returns the ASCII character whose 
code is the value of the expression. 


Value must be in range 0 to 255 inclu- 
sive. 


Real values are converted to integers. 


CHR$ has no meaning for string vari- 
ables. 


Token 


Class 


Conditions 


Note 


189 


Editing and Format Command 


CLEAR 


Sets values of all variables and arrays 
to zero, and all string variables and ar- 
rays to the null value. 


Resets pointers and stacks used by the 
operating system. 


Does not delete the program. 


In multiple runs with one or more 
changing variables, reinitialization of 
parameters will be required after 
CLEAR. 


CLEAR 


COLOR= 


Token 


Class 


Forms 


Conditions 


160 


Graphic and Game Command 


COLOR= 


COLOR = number 
COLOR = expression 


Sets the color for plotting in the low 
resolution mode. 


Numbers and expressions are eval- 
uated modulo 16, and are limited to the 
range 0 to 255 inclusive. If real, they are 
converted to integer form. 


COLOR is set to 0 by the GR command. 


In the text mode, COLOR affects PLOT 
characters. 


In high resolution graphics, COLOR is 
ignored. 


See Appendix H, Codes and Desig- 
nators for COLOR. 


Token 187 Name Continue 


Class System and Utility Command 


CONT 


Conditions Used to resume program execution 
after a STOP, END, or control C com- 
mand. Execution resumes at next in- 
struction, not next line number. 


May not operate properly after control 
C, since this clears some pointers and 
stacks, for example, during INPUT 
execution. 
CONT 
Results in error message after a halt if 
—any program line is deleted or 
modified. 
—any error message has oc- 
curred. 
(However, variables may be modified 
during the halt.) 


If CONT is used within a program it 
causes a halt, with blocked program 
control. Use control C to regain control. 


Token 


Class 


Forms 


Conditions 


222 Name Cosine 


Mathematical Function 


COS 


COS (number) 
COS (variable) 
COS (expression) 


Returns the cosine of an angle ex- 
pressed in radians. 


COS has no meaning for string quan- 
tities. 


Token 


Class 


Form 


Conditions 


131 


INPUT OUTPUT Command 


DATA 


DATA Item 1, Item 2, .... 


Creates a list of items which can be 
used by READ statements. 


Items can be literals, strings (enclosed 
in quotes), or numerical values, in 
order, separated by commas. 


Items in DATA statements must be 
added in the order in which the line 
numbers are encountered and then in 
the order in which the items are to be 
used. 


DATA can appear anywhere in a pro- 
gram, even before the READ com- 
mand. 


A numeric item cannot include a 
comma. 


In a string, spaces before first element 
and following the string are ignored. 


A Quotation Mark with a DATA item 


DATA 


Causes an error message, but all other 
characters are accepted except Control 
X and Control M. 


In a literal, the colon, comma, Control X 
and Control M are not accepted. An 
initial quotation mark is not accepted. 


A nonexistent element occurs if 
—There is no nonspace character 
between two commas. 
—A comma is the last nonspace 
character before RETURN. 


If READ requires an input for a non- 
existent element, it is interpreted as a 
zero if a numeric is required, or as a null 
if a string is required. 


See INPUT, READ. 


Token 


Class 


Form 


Conditions 


184 Name DEFine (Function) 


Input-Output Command 


DEF 


DEF FN name (argument) = expres- 
sion 


Used with FN to define a function for 
subsequent use. 


The expression may be only one state- 
ment in length. 


The named function may be redefined 
at any point in the program, with the 
current definition being used when 
named function is again encountered. 


The expression may contain any num- 
ber of variables, but integer variables 
are not allowed. 


The argument following name is a 
dummy variable, replaced at FN use. 


The variable following the name does 
not need to appear in the defining ex- 
pression. In this case the using FN ar- 
gument is ignored. 


DEF 


Note 


The defined function is used by the 
Form: FN name (argument), where ar- 
gument may be anumber, a variable, or 
an expression. 


String functions may not be defined. 
The name and variable may not be in- 
teger types. 


DEF FN cannot be used in the im- 
mediate execution mode. 


See FN. 


Only the first two characters in a vari- 
able name are evaluated. The rest are 
ignored unless they include a reserved 
word, which produces an error input. 


Token 


Class 


Form 


Conditions 


Note 


Caution 


133 Name Delete 


Editing and Format Command 


DEL 


DEL line number 1, line number 2. 


Deletes the line or lines from line 
number 1 to line number 2, inclusive. 


Is ignored if line number 1 is greater 
than line number 2. 


If line number 1 does not exist in the 
program, deletes the next larger line 
number. 


If line number 2 does not exist in the 
program, deletes the next smaller line 
number. 


If encountered in program execution, 
deletes stated lines, then halts execu- 
tion, which cannot be resumed by 
CONT. 


For single line deletion, enter the line 
number only. 


Be careful with names in a program. 
They must not include key words. 


DEL 


Token 


Class 


Form 


Conditions 


134 Name Dimension 


Array and String Command 


Dim variable (subscript 1, subscript 2 


=) 


Reserves space in memory for an array 
of dimension equal to the number of 
subscripts. 


Only one array of a given name can 
exist, even though dimensions are 
specified to be different. Only last entry 
is retained. 


The number of dimensions is limited to 
88. 


The magnitude of the subscripts is lim- 
ited only by available memory. 


Arrays may be dimensioned by vari- 
ables or by expressions, but variables 
must have been defined before DIM is 
encountered. 


The number of elements in the array is 
equal to the product, (1 + subscript 1) х 
(1 + subscript 2)... 


If not specifically set by DIM, an array is 
assumed to have 10 as the subscript 
value (11 elements, including the ze- 
roeth). 


Individual strings in a string array are 
not dimensioned, but grow or shrink as 
necessary. The maximum length is 255 
characters. 


Array element values are set to 0 or null 
by RUN or CLEAR. Use GOTO to avoid 
this. 


Memory use is (per element) 
—integer numbers: 2 bytes 
—real numbers: 5 bytes 
—strings: 3 bytes plus 1 per 
character. 


Silena Heights College Library 


Adrian. Michigan 49221 


DRAW 


Token 


Class 


Forms 


Conditions 


Note 


148 


Graphics and Games Command 


DRAW 


DRAW Shape number AT X coordinate, 
Y coordinate 


DRAW Shape number 


In high resolution graphics, places a 
previously defined Shape identified by 
the Shape number (range 0-255) at the 
screen location X, Y. 


Color, rotation, and scale of the Shape 
are defined by a table, set up by 
SHLOAD or by the monitor program. 
The number may be an expression. 


lf AT and coordinates are omitted, the 
Shape is placed at the last plot point 
defined by HPLOT, DRAW, or XDRAW. 


Coordinates may be defined by expres- 
sions or variables or given explicitly. 
Maximum range of X is 0 to 278 and of Y 
is O to 191, both inclusive. 


Use XDRAW to erase the Shape when 
desired. 

Endless loops and random Shapes 
may occur if DRAW is used before a 
Shape table is entered. 

See AT, HPLOT, XDRAW. 


Token 


Class 


Conditions 


128 


System and Utility Command 


END 


Used to stop execution of a program 
and return control to keyboard user. 


No message is printed. 


After END, CONT causes execution re- 
sumption, starting at the next instruc- 
tion, not the next line number. CONT 
has no effect if there is no further pro- 
gram. 


Token Name Exponential 


Class Mathematical Function 


EXP 


Forms EXP (number) 
EXP (expression) 
Conditions Returns the value of the base of natural 
logarithms (e) raised to the power of the 


number or evaluated expression. 


e is evaluated to six places, e = 
2.718289. 


Token 159 


Class Editing and Format Command 


FLASH 


Conditions Sets the screen display to alternate be- 
tween normal and inverse characters 
(alternately white on black background, 
then black on white). 


Continues to function until NORMAL 
(white on black) or INVERSE (black on 
white) is encountered. 


FLASH affects output but not input. 


FLASH 


Token 


Class 


Form 


Conditions 


194 Name Function 


Mathematical Function 


FN 


FN name (argument) 


Returns the value resulting from the 
application of the previously named 
function (defined by DEF ЕМ...) to the 
argument which replaces the dummy 
argument used in the definition. 


The name may not be an integer type of 
variable, and string functions are not 
allowed. 


The argument may be a number or an 
expression, and need not include the 
variable used in the definition. 


FN can be used in immediate execution 
although the function can only be de- 
fined in the program execution mode. 


See DEF. 


Token 


Class 


Form 


Conditions 


129 


Flow of Control Instruction 


FOR 


FOR variable = initial value TO limit 
value STEP increment 


The initial element of a FOR-NEXT 
loop. 


The variable must be real, not an in- 
teger. Initial, limit, and increment values 
may be real or integer values. 


The value of the variable is set to its 
initial value (a numerical or another 
variable or evaluated expression), and 
then execution continues until NEXT is 
encountered; the variable value is then 
incremented by the increment, if given, 
or by 1, if not. The result is tested 
against limit. If the limit is exceeded, the 
statement following the NEXT is exe- 
cuted; otherwise execution returns to 
the statement following the FOR con- 
struct. 


The variable cannot be a string or in- 
teger variable. 


FOR 


Initial, limit, and increment values are 
not restricted to integer values. 


A FOR-NEXT loop may be completely 
within another one (nested), but loops 
may not cross. A maximum of ten loops 
in a nest are allowed. 


A FOR-NEXT loop can be run in the 
immediate mode if all parts, including 
any intermediate statements, can be 
placed on one line (maximum 239 
characters). 


See TO, NEXT, STEP. 


Token 


Class 


Forms 


Conditions 


214 Name Free Memory 


Editing and Format Function 


FRE 


FRE 
FRE (any legal expression) 


FRE returns the amount of memory (in 
BYTES) still available to the user. If any 
negative number is returned, add 
65536 to get the actual amount. 


FRE (expression) returns the free 
space below string storage space and 
above the numeric array and string 
storage space. The expression is a 
dummy value, but must be evaluatable. 


FRE (exp) also clears unused variable 
data from the area. LET X = FRE (0) 
can be included in a complex program 
to do this. 


To check available memory during pro- 
gram entry, use PRINT FRE(0). 


Code 190 


Class Input-Output Command 


GET GET 


Form GET variable name 


Conditions Fetches a single character from the 
keyboard (with some complexities). 
Does not display this, or require RE- 
TURN. Stores the value in the name 
variable. 


Complexities: 

—Control @ returns a null charac- 
ter. 

—A<or Control H may cause a 
blank space on the screen. 

—Control C does not halt program 
execution. 

—For arithmetic variables, a colon, 
comma, plus, minus, Controle, 
Control E, space and period re- 
turn a 0. A RETURN or non- 
numeric character causes an 
error message and execution 
halt. 


Hint To avoid most complexities, GET a 
string variable, then convert it to a 
numeric using the VAL function. 


Token 


Class 


Form 


Conditions 


Hint 


176 Name GO to Subroutine 


Flow of Control Command 


GOSUB 


GOSUB line number 


Causes a program branch to a sub- 
routine located at specified line num- 
ber. Execution proceeds with ensuing 
lines, until RETURN is encountered. 
Program execution then is transferred 
to the statement following the GOSUB. 


Subroutines may call other subrou- 
tines, up to a limit of twenty-four levels. 


See RETURN. 


The search for the called line starts at 
line 0. Program execution will be faster 
if subroutines are placed early in the 
program with the ones called most often 
first. 


GOSUB 


GOTO 


Token 


Class 


Forms 


Conditions 


171 


Flow of Control Command 


GOTO 


GOTO line number 

IF condition GOTO line number 
Causes a jump to the specified program 
line, with program execution resuming 


with the line specified. 


See also IF. 


Token 


136 Name Low Resolution Graphics 


Class Graphics and Game Command 


GR 


Conditions Sets the low resolution graphics mode 


Hint 


of forty lines of forty elements each, with 
space for four elements each, with 
space for four lines of text at the bottom 
of screen. 


Clears screen to black, sets COLOR to 
0, and cursor to the bottom text line. 


The coordinate origin is the upper left, 
with X and Y varying from 0 to 39. 


Low resolution graphics and text are 
stored in the same memory area. GR 
deletes the upper twenty lines of text. 


HOME in GR mode sets cursor to bot- 
tom of screen. 


The text area can be converted to 
graphics by following GR with POKE 
—16302,0. The color pattern can be 
controlled by key usage. 


In TEXT mode, POKE —16304,0 con- 
verts entire screen to graphics without 
clearing it. Colors may be controlled by 
key usage. 


GR 


Token 146 Name High Resolution Color 


Class Graphics and Games Command 


HCOLOR 


Conditions Sets high resolution graphics to color 
values designated by the integers 0-7 
inclusive. 


HCOLOR The exact color depends on the TV and 
its adjustment; for Н COLOR =5, white 
will be obtained only if both dots (X,Y) 
and (X+1,Y) are plotted. For X-odd, the 
color is green(ish) and for X-even, the 
color is blue(ish). 


Until the first HCOLOR is executed, 
screen color is indeterminate. 


HCOLOR is not changed by HGR, 
HGR2, or RUN. It has no influence on 
low resolution graphics. 


See Codes and Designators for 
COLOR, HCOLOR. 


Token 


145 Мате High Resolution Graphics, 


Class Graphics and Games Command 


HGR 


Conditions Sets the high resolution graphics mode, 


Notes 


280 positions horizontally by 160 posi- 
tions vertically. Four test lines may be 
displayed at the bottom of the screen. 


The origin of X-Y coordinates is 0,0 at 
upper left of screen. 


The screen is cleared to black, and НЕК 


Page 1 of the graphics memory is dis- 
played. 


While only four text lines are displayed, 
all lines are available for text (stored 
separately), and will be displayed when 
the TEXT command is used. 


The cursor can be moved off screen by 
Escape 1, or by HOME. 


HGR is not available in Cassette Ap- 
plesoft. 


POKE 49234,0 converts screen to 280 
positions horizontally by 192 positions 


vertically (full screen). 


In very long programs, high resolution 
screen and program data may overlap. 
HGR2 can sometimes be used to 
minimize the risk of this. 


Token 144 Name High Resolution Graphics, 
Page 2 


Class Graphics and Games Command 


HGR2 


Conditions Sets full screen, high resolution graph- 
ics, 280 positions horizontally by 160 
positions vertically, and clears screen 
to black. 


Blanks between the 2 and H are op- 
tional. 


HGR2 


This is Page 2 of graphics memory, but 
itis not available with less than 24K of 
memory. 


While text is not displayed, it is entered 
into text storage and is available by 
using the TEXT command. 


Use HGR2 instead of HGR to maximize 
program memory. On 24K systems, 
setting HIMEM:16384 will protect the 
screen area from programs. 


Token 


Class 


Forms 


Conditions 


163 Name SET High Memory Limit 


System and Utility Command 


HIMEM: 


HIMEM: number 
HIMEM: variable 
HIMEM: expression 


Sets the upper bound of memory avail- 
able to a BASIC program. The expres- 
sion must be in the range —65535 to 
65535 inclusive. However, practical 
maximums depend on installed mem- 
ory, as follows: 


16K 16384 
32K 32767 
64K 49152 


HIMEM is a system variable, normally 
automatically set to highest available 
memory. PRINT PEEK (116)* 256 + 
PEEK (115) will return the current 
value. 


Use to protect a memory area, say fora 
machine language program. 


See LOMEM.:. 


Token 


Class 


Form 


Conditions 


HLIN 


142 Name Place Horizontal Line 


Graphics and Games Instruction 


HLIN 


HLIN start, end, AT line number 


In low resolution graphics, HLIN places 
a horizontal line on the numbered line, 
starting and ending as designated. 


Line values may be numerical, a vari- 
able or an expression, allowed ranges 
being: 


Start-Line 0-39 
End-Line 0-39 
Line Number 0-47 


Line color is set by the most recent 
COLOR statement. 


In text, with COLOR set to other than 
zero, HLIN places a specified row of 
characters on screen. COLOR = 0 de- 
letes any character in the specified row. 


HLIN has no visible effect in the high 
resolution graphics mode. 


Token 151 


Class 


Conditions 


Note 


Editing and Format Command 


HOME 


In the TEXT mode HOME moves the 
cursor to the upper left corner and 
clears all text. 


In GR and HGR modes, HOME moves 
the cursor to the upper left of text area 
and clears all text. 


In HGR2, there is no visible effect. 


HOME is identical to CALL —936 and to 
Escape @ return. 


Token 


Class 


Forms 


Conditions 


Warnings 


147 Name High Resolution Plot 


Graphics and Games Instruction 


HPLOT 


HPLOT X, Y 
HPLOT TO X, Y 
HPLOT X, Y, TOX Y. TOM, Y, «ve 


Used to plot or draw in the high resolu- 
tion graphics mode. 


In simple form, HPLOT places an ele- 
ment at the X, Y coordinates; X can 
range from 0 to 279, Y can range from 0 
to 159 (normal)orO to 191 (full screen), 
all inclusive. 

If HPLOT is followed by TO, it draws a 
line from the last point plotted to the 
indicated coordinates. 


In full form, it plots from coordinates X,, 
Y, to X, У, 10%, Y... (Up to the 
instruction limit of 239 characters). 


The color is the last color specified by 
HCOLOR. 


HPLOT must be preceded by HGR or 
НОН? to avoid overwriting the program 
and its data. 

An attempt to plot outside the limits (x 
from 0 to 279, Y from O to 191) produces 
an error. 


Token 


Class 


Forms 


Conditions 


Note 


Warning 


150 Name Horizontal Tabular Set 


Editing and Format Instruction 


HTAB 


HTAB number 
HTAB variable 
HTAB expression 


Used to set the print position to the indi- 
cated value, which must be in the range 
0 to 255. 


Position 1 is the left most position of the 
line containing the cursor. Position 40 is 
the right most; position 41 is the left 
most position of the next line down and 
so on. TABO is evaluated as position 
256, that is, position 16 of line 6 down. 


HTAB cannot be used as an item ina 
print list. Precede and follow it with a 
semicolon to control the print position, 


which may precede an item already | 


printed on the same line. 


It is possible to place one character off 
screen. 


HTAB 


Token 


173 


Class Flow of Control Instruction 


IF 


Forms IF condition THEN Instruction 


Conditions 


Caution 


IF condition THEN GOTO line number 
IF condition GOTO line number 


IF sets up a branching test in the forms 
shown. 

Ifthe condition evaluates as nonzero, or 
true, the instruction following the THEN 
is executed. 


If the condition evaluates as zero, or 
false, program execution is transferred 
to the next numbered line. 

The general form THEN GOTO line 
number can be simplified by omitting 
either THEN or GOTO. 

Mixed arithmetic-string expressions in 
conditions are evaluated by comparing 
the ASCII numerical values of charac- 
ters. 

A null string literal is evaluated as zero. 


All other strings are evaluated as true. 


Repeated string evaluation may halt the 
program. 


All instructions following THEN that are 
on the same line will not be executed if 
the condition evaluates as false. Multi- 
ple instructions on lines with IF-THEN 
constructs can be sources of errors. 


Token 139 Name Select Input Slot 


Class Input-Output Instruction 


INF 


Form IN# slot-number. 


Conditions Selects the peripheral or device 
plugged into a master board slot for 
subsequent INPUT. 


The value of the slot may be a numeric 
value, a variable, or an expression. 


The slots and devices are numbered 
1-7 inclusive, and the values must be 
within this range. 


IN#0 indicates that input will be from 
the keyboard. 


The instruction boots the disk if the disk 
controller is present at the specified 
Slot. IN# 


Warnings Values between 8 and 255 may create 
a hang condition. Values greater than 
256 will produce an error. 


INPUT 


Token 


Class 


Form 


Conditions 


132 


INPUT-OUTPUT 


INPUT 


INPUT “String”; variable 1, variable 2 . . 


Used to request an input (normally 
identified on the screen by a string in 
quotes), and to accept values of the 
variable or variables listed. 


The string to be printed on the screen 
must be separated from the variables 
by a semicolon, and the variables by 
commas. 


Responses to a variable request must 
be appropriate to the variable type. The 
input values for the variables must be 
separated by commas. A leading com- 
ma or semicolon is evaluated as a null 
input. 

Extra values are ignored; a message is 
printed; and execution continues. 


The string and the semicolon may be 
omitted. In this case, only the ? prompt 
is printed. 


If insufficient variables are input, a ? 
prompt results. 


Token 


Class 


Forms 


Conditions 


211 Name Integer Value 


Mathematical Function 


INT 


INT (number) 

INT (variable) 

INT (expression) 

Returns the largest integer that is less 
than or equal to the evaluated expres- 
sion, current value of variable, or sup- 


plied number. 


INT has no meaning for string quan- 
tities. 


INT 


INVERSE 


Token 158 


Class Editing and Format Command 


INVERSE 


Conditions Used to set video output display to 
show black characters on a white 
background. 


Does not affect display of input char- 
acters. 


Use NORMAL to return to white on 
black display. 


Use FLASH to alternate between the 
two. 


Token 


Class 


Form 


Conditions 


232 Name Left String Slice 
LEFT 


Array and String Function 


LEFT$ 


LEFT$ (object string, character select) 


Applied to an object string, returns the n 
left-most characters. 


The object string may be a literal, a 
string variable, or a string expression. 


The character select may be a number, 
a variable, or an expression. A real 
number is converted to an integer 
(Range 1 to 255 inclusive). 


See RIGHT$, MID$; use + for string 
concatenation. 


LEN 


Token 


Class 


Form 


Conditions 


227 Name String Length 


Array and String Function 


LEN 


LEN (string expression) 


When applied to a string variable or ex- 
pression, LEN returns the length of the 
string in number of characters, includ- 
ing spaces. 


An error results if length of the string is 
greater than 255 characters. 


Token 170 


Class Input/Output Instruction 


LET 


Form LET variable — Value 


LET 


Conditions Used to assign a value to a variable. 


Either string or numerical assignments 
can be made, but the variable and value 
must be the same type. However a lit- 
eral will be evaluated as numerical, if 
possible, if assigned to an arithmetic 
variable. 


The variable may be superscripted. 


LET also defines the variable if it has 
not been previously defined. 


LET is optional. The form A —2 is valid, 
and defines the variable if it has not 
been defined by a previous statement. 


For numerics, the value may be a literal, 
another variable, or an expression; and 
for strings, the value may be a string, 
another string variable, or a string ex- 
pression. 


LIST 


Token 


Class 


Forms 


Conditions 


Note 


188 


Editing and Format Command 


LIST 


LIST 

LIST line number 

LIST line number 1, line number 2 
LIST line number 


Displays the program in memory on 
screen, as follows 
—if line number, that line only. 
—if two line numbers separated by 
a comma (or other delimiter), 
from line number 1 to line num- 
ber 2 inclusive. 
—if a line number followed by a 
comma (or other delimiter), from 
line number to end of program. 


(Some other forms are possible.) 


Use SPEED =h to set rate of character 
display. 


Reset terminates listing immediately. 
Control C terminates listing at the end of 


the line being listed and transfers con- 
trol to the keyboard. CONT resumes 
LIST. 


Use Control S to suspend LIST. The 
pause occurs at the end of the line. Any 
key restarts it. 


Token 182 


Class System and Utility Command 


LOAD 


Conditions Used to input a program from magnetic 
tape to memory. 


LOAD 


Tape operation is manual; press return 
before starting the tape. 


When the data flow starts, any program 
in memory is erased. 


Tape recorder volume level is critical. 


Use RESET to interrupt the loading 
process. 


Inclusion of LOAD in any name may 
cause loss of program and system 
hang-up. 


Using LOAD with no tape recorder input 
available will cause the computer to 
wait indefinitely for input. Use RESET to 
escape. The current program is not lost. 


In Disk Basic, LOAD becomes LOAD 
name plus optional parameters. This 
command will transfer the named pro- 
gram from disk to memory. 


Token 


Class 


Form 


Conditions 


220 Name Natural Logarithm 


Mathematical Function 


LOG 


LOG (variable) 

LOG 
Returns the natural logarithm of the 
variable, which may be a number, a 
variable, or an expression (whose cur- 
rent value is used). 


LOG has no meaning for string quan- 
tities. 


LOMEM: 


Token 


Class 


Forms 


Conditions 


Hint 


164 


System and Utility 


LOMEM 


LOMEM: number 
LOMEM: variable 
LOMEM: expression 


Sets the address of the lowest memory 
available to a BASIC program. 


The value may range between —65535 
and +65535. However, an out-of-mem- 
ory error will occur if 

—Low memory is set higher than 
the High memory limit. 

—Low memory is set below the 
highest memory of the operating 
system plus any stored program 
(about location 2051). 


To see current value, use PRINT PEEK 
(106) + 256 * PEEK (105). 


On 24K systems, set Low Memory to 
16384 to protect variables from high 
resolution graphics. 


Warning 


LOMEM: is reset by NEW or DEL, or by 
adding or changing a program line, and 
by Control B, which deletes the pro- 
gram. 


Changing LOMEM during program 
execution can cause execution errors. 


MID$ 


Token 


Class 


Forms 


Conditions 


234 Name Middle String Slice 


Array and String Function 


MID$ 


MID$ (object string, left character 
select, number character select) 


MID$ (object string, left character 
select) 


Applied to an object string, MID$ re- 
turns the characters starting with the 
one in the position indicated by the left 
character select value, and proceeding 
to the right for the number of characters 
designated. If the number character 
select value is omitted, selection pro- 
ceeds to the end of the string. 


The object string may be a literal, or 
may be designated by a string variable 
or string expression. 


The character selectors may be num- 
bers, variables, or expressions. A real 
number is converted to an integer 
(range 1-255 inclusive). 


See LEFT$, RIGHT$: Use + for string 
concatenation. 


Token 


Class 


Conditions 


Note 


191 


System and Utility Command 


NEW 


Used to prepare for a new program. 


Deletes the current program and all 
variable assignments. 


Does not actually clear the program and 
variable values in memory. It simply 
removes the pointers. 


Special programs that can recover 
stored variable values exist. 


NEXT 


Token 


Class 


Forms 


Conditions 


Hint 


130 


Flow of Control Instruction 


NEXT 


NEXT variable name 
NEXT variable name, variable name, . . 


NEXT 


The second, or terminating, element of 
a FOR-NEXT loop. 

The action occurring when NEXT is en- 
countered depends on the test set up in 
the FOR statement. If test conditions 
are not satisfied, the sequel following 
the FOR statement is executed. If the 
test is satisfied, execution continues 
with the statement following the NEXT. 
If several loops end at the same point 
their identifying variables may follow 
the NEXT. The sequence must be cor- 
rect. 

If the variable name is omitted, the 
NEXT is assumed to apply to the most 
recent FOR. 

In immediate execution, the FOR 
and NEXT, and all intervening state- 
ments, must be entered before RE- 
TURN is pressed. 


See FOR. 


FOR-NEXT loops execute faster if the 
variable name is omitted in the NEXT 
statement. 


Token 


Class 


Conditions 


157 


Editing and Format Command 


NORMAL 


Sets the display mode to white letters 
on a black background for both input 
and output. 


See INVERSE, FLASH. 


NORMAL 


Token 198 


Class Relational Operator 


NOT 


Form NOT variate 

Conditions The relational inverting operator NOT 
converts a logical true value (1) to a 
logical false value (0), and vice versa. 
NOT acts as a unary operation, affect- 
ing the immediately following variate. 
Parenthesis must be used to apply it to 
an entire expression. 


NOT has no meaning for string vari- 
ables. 


Examples МОТ 0 = 1 
NOT 1 =0 
NOT 9 =0 


NOT -9 =0 


Token 156 


Class System and Utility 


NOTRACE 


Conditions Terminates a debug mode set up by 
TRACE, which is used to print line 
numbers on the screen tracing program 
execution. 


See TRACE. 


NOTRACE 


Token 


Class 


Forms 


Conditions 


180 


Flow of Control Instruction 


ON 


ON condition GOTO line number 1, line 
number 2... 


ON condition GOSUB line number 1, 
line number 2... 


If the condition evaluates to 1, ON 
causes a branch to the first line number 
listed. If it evaluates to 2, a branch is 
made to the second line number listed, 
and so on. 


If the condition evgluates to O or to a 
number greater than the number of line 
numbers listed, execution proceeds to 
the next program statement. 


The condition may be a variable or an 
expression, but it must evaluate to less 


than 256 but not less than O. 


Token 165 Name On Error Routine 


Class Flow of Control Instruction 


ONERR 


Form ONERR GOTO line number 


Conditions Use to avoid having an error message 
printed and execution halted when an 
error occurs in program execution. 
(Typical use: to detect the divide by 
zero encountered error.) 


Must be executed at least once before 
error is encountered to prevent execu- 
tion halt with error message. 


Use RESUME at end of error avoidance 
routine (but see below). Execution re- 
sumes at beginning of error producing 
statement. ONERR 


Warnings Within FOR-NEXT loops, or between 
GOSUB and RETURN, return should 
be to the FOR or GOSUB, not to the 
error producing statement. The service 
routine must do the necessary cleanup. 


Token 


Class 


Form 


Conditions 


206 


Relational Operator 


OR 


Relation 1 OR relation 2 


The arithmetic logical operator OR as- 
sumes the value true if either relation 1 
or relation 2 is true, or if both relations 
are true. 


There may be more than one OR in 
sequence. OR has the lowest priority in 


expression evaluation. 


May be combined with NOT in the forms 
NOT relation 1 OR NOT relation 2, and 
so forth. 


OR has no meaning for string expres- 
sions. 


Relations are true if nonzero 


Truth table for OR 


чаш тт > 
ата т< 


Code 


Class 


Form 


Conditions 


Note 


Warning 


Hint 


216 Name Read Paddle Input 


Graphics and Games Function 


PDL 


PDL (paddle number) 


Reads the current paddle position (as 
an integer between 0 and 255) of one of 
four paddles specified by a paddle 
number, which may be a number, a 
variable, or an expression in the range 
0-3. 


Paddle input involves an analog to dig- 
ital conversion, which is slower than 
machine operation. Allow several pro- 
gram lines between two successive 
paddle reads by using a program loop if 
necessary. 


Attempts to select a paddle number 
greater than three may affect program 
execution. 


The paddle control circuit is essentially 
a 0-150K variable resistor. It is useful in 
many control and measurement appli- 
cations. 


PEEK 


Token 


Class 


Form 


Conditions 


Note 


226 


System and Utility Function 


PEEK 


PEEK (address) 


Returns the byte stored at the given 
address. Both address and the returned 
quantity are in decimal numbers. The 
address may be given as a number, a 
variable, or an expression, and may be 
positive or negative. 


See POKE. 

Thorough understanding of system 
variables and their addresses is neces- 
sary to obtain maximum use of PEEK 


and its companion, POKE. 


Minus address = true address —65535. 


Token 


Class 


Form 


Conditions 


141 


Graphics and Games Instruction 


PLOT 


PLOT X coordinate, Y coordinate 


In low resolution graphics, places a dot, 
a pixel or picture element, at the posi- 
tion given by the coordinates. 


The coordinate value may be given 
numerically, by a variable, or by an ex- 
pression. X values must be in the range 
0-39, and Y values, in the range 0-47, 
with 0,0 at the upper left. 


The color plotted is that given by the 
most recent COLOR statement; or 
COLOR = 0 is used if COLOR has not 
been previously specified. 


In the Text or Graphics plus Text 
modes, for Y in range 40-47, PLOT 
places a character at the location 
specified. The character code corre- 
sponds to the color code. 


There is no visible effect in the High 
Resolution Graphics mode. 


PLOT 


Token 185 


Class 


Form 


Conditions 


System and Utility Command 


POKE 


POKE address, quantity 


Stores the (byte) quantity at the ad- 
dress indicated. Both quantity and ad- 
dress are in decimal and either may be 
specified by anumber, a variable, or an 
expression. The maximum range of ad- 
dresses is —65535 to 65535, and of the 
quantities O through 255. Real values 
are converted to integers. 


Receiving hardware must be present at 
the address for successful use. For 
Memory, this is 0 to 


16K - 16384 
32K - 32768 
48K - 49152 


Memory mapped peripherals are nor- 
mally at $С000 through $CO7F (deci- 
mal 49152 through 49279) (or —16384 
through — 16257). 


See PEEK. 


Note Thorough understanding of system 
variables and their addresses is neces- 
sary to obtain maximum use of POKE 
and its companion PEEK. 


Warning Careless use of POKE may alter sys- 
tem and/or program performance. 


Token 161 Name POP RETURN STACK 


POP 


Class Flow of Control Command 


POP 


Conditions “Pops” or removes one address from 
the GOSUB-RETURN address stack. 


The effect is to return to the second- 
most recent GOSUB, rather than to the 
most recent. 


Produces an error signal if there are no 
addresses on the stack. 


Token 


Class 


Form 


Conditions 


Note 


Hint 


217 Name Read Cursor Position 


Editing and Format Function 


POS 


POS (dummy expression) 


Returns the column number or hori- 
zontal position of the screen cursor. 


The expression is adummy but must be 
evaluatable as a numeric. 


For POS and SPC, positions are num- 
bered from 0, while for HTAB and TAB 


they are numbered from 1. 


POS (8) or POS (9) are simple forms. 


Token 


Class 


PRINT 


Form 


Conditions 


186 


Input-Output Instruction 


PRINT 


PRINT print-list 


Causes the items of the print-list to be 
displayed on the screen. 


An empty list causes a return and line 
feed. 


A single item in the print list, or a last 
item with no following punctuation, is 
printed on its own line. 


Two or more items separated by 
semicolons are printed with no inter- 
vening spaces. A terminal semicolon 
holds the print position until the next 
print list. 


If separated by a comma, the next item 
is placed in the next available tabular 
location. 


Items in quotes (strings) are printed 
without the quotes. 


In a print list of numbers followed by 


Hints 


periods, usually interpreted as a literal, 
the terminal period prints as 0. 


The maximum total string length is 255 
characters. 


Numerical values may use from 1 to 19 
print positions. 


See TAB, SPC. 
The range of variation in the print-list is 


very large. Practice trials are recom- 
mended. 


A ? can be used in lieu of PRINT. It lists 
as PRINT. 


Token 


Class 


Form 


Conditions 


Warnings 


198 Name Select Output Slot 


Input-Output Command 


PR#Ë 


PR# slot-number 


Transfers output to the peripheral lo- 
cated in the designated slot. 


The slot number may be a numeric, a 
variable, or an expression, and must 


evaluate to the range 1-7 inclusive. 


A value of O returns output to the TV 
screen. 


A value less than 0 or more than 7 pro- 
duces an error report. 


PR# boots the disk if the specified slot 
contains a disk controller. 


If there is no peripheral in the specified 
slot, the system will hang. 


Use Control C and RETURN to escape. 


Token 


Class 


Form 


Conditions 


135 


Input-Output 


READ 


READ variable 1, variable 2,.... 


When encountered, READ sets the 
value of the specified variable or vari- 
ables to the value of the elements of 
DATA lists, starting from first variable in 
the first READ statement and the first 
value in the DATA statement, and con- 
tinuing through the DATA list or lists 
until the READ list or lists are satisfied. 


If the DATA lists are shorter than READ 
lists, an error message results. How- 
ever, there is no indication if the DATA 
list is longer. 


In immediate mode, READ attempts to 
find DATA lists in the stored program. 


The position in the READ list is re- 
corded. It may be setto the beginning of 
the DATA list by the RESTORE state- 
ment. (It is not automatically reset by an 
immediate mode execution of a READ.) 


READ 


RECALL 


Token 


Class 


Form 


Conditions 


Warning 


167 Name Recall Tape Stored Array 


Array and String Command 


RECALL 


RECALL name 


Recalls an array stored on tape and 
reads its values into the named array. 


Since STORE does not actually store 
the name of its named array, any input 
array will be accepted. 


Unless the requested and stored arrays 
match in dimensions, scrambled num- 
bers, false zeros, and/or error mes- 
sages will be encountered. 


Arrays must be numeric. (String arrays 
may be converted using the ASC 
statement.) 


Tape operation is manual. An audible 
signal occurs at the beginning and end 
of the tape record. 


The RECALL function can be inter- 
rupted only by RESET. 
See STORE. 


While useful in systems having no disk 
drive, care is necessary. Review the 
instruction book. 


Token 


Class 


Form 


Conditions 


178 Name Remark 


Editing and Formatting Command 


REM 


REM characters 


REM is a command to ignore, during рем 
program execution, all following char- 
acters (including statement separators 
and blanks), until a return (line feed) is 
encountered. 


There is no limit to REM length, (up to 
available memory). 


Token 


Class 


Conditions 


RESTORE 


Note 


174 Name Restore Data List Pointer 


Input-Output Command 


RESTORE 


Resets the data list pointer to the be- 
ginning of the data list. 


See READ, DATA. 
The beginning of the data list is the first 


value following the first DATA state- 
ment in the program. 


Token 166 Name Resume Execution 


Class Flow of Control Command 


RESUME 


Conditions Used at end of an error handling routine 
to cause program execution to resume 
at the beginning of the statement that 
contained an error. 


Warnings  Ifthe error handling routine has not cor- 
rectly dealt with the error, an endless 
loop results. Use Control C, and RE- 
TURN to escape. 


RESUME 


If RESUME is encountered before an 
error has occurred, the effect may be 
unpredictable. Usually execution will 
cease. 


In the immediate mode, RESUME may 
have an unpredictable effect, including 
initiation of existing or deleted pro- 
grams. 


RETURN 


Token 


Class 


Conditions 


Note 


177 


Flow of Control Command 


RETURN 


The signal to end aGOSUB subroutine. 


When encountered, RETURN causes a 
branch to the statement following the 
most recently executed GOSUB; that 
is, the address of the statement at the 
top of the GOSUB stack. 


Using a RETURN without a GOSUB or 
having more RETURNs than GOSUBs 
causes an error message. 


POP affects the GOSUB order of 
execution, but continue to watch the 
number of RETURNs. 


See GOSUB, POP. 


Token 


Class 


Form 


Conditions 


233 Name Right String Slice 


Array and String Function 


RIGHTS 


RIGHTS (object string, character se- 
lect) 


Applied to the object string, this function 
returns the number of right-most char- 
acters indicated by the character select 
value. 


The object string may be a literal, a 
string variable, or an expression. 


The character select may be a literal, a 
variable, or an expression. A real 
number is converted to an integer 
(range 1 to 255 inclusive). 


See LEFT$, MID$. Use + for string 
concatenation. 


RIGHTS 


Token 


Class 


Form 


Conditions 


219 Name Random Number 


Mathematical Function 


RND 


RND (indicator) 


RND returns a pseudorandom number; 
that is, one of a distribution that is ran- 
dom by test but that is generated ac- 
cording to a rule. 


The indicator may be a number, a vari- 
able, or an expression. 


If the indicator is a negative value, a 
particular random number that is al- 
ways the same for that negative num- 
ber is generated. Subsequent positive 
arguments return a particular, repeat- 
able sequence. 


If the indicator is positive, without a prior 
negative value, a new random number 
is generated for each use. 


If the indicator is 0, the most recent 
random number is returned. 


The value of RND ranges from 0 to 1, 
but is never unity. 


Token 152 Name Rotate Shape 


Class Graphics and Games Instruction 


ROT= 


Form ROT = Angle 


Conditions ROT= causes a previously specified 
shape to be rotated clockwise about its 
reference point; that is, it sets the an- 
gular rotation of the shape to be placed 
on the screen by DRAW or XDRAW. 


The angle is based on 64 parts of a 
circle, that is, angle = 32 is a rotation of 

180° clockwise. 

. ROT= 
The value of angle is affected by 
SCALE. For SCALE = 1 only the four 
values 0, 16, 32, 48 are recognized. For 
SCALE = 2, eight values are recog- 
nized, and so on. 


Intermediate values usually give the 
next smaller recognized value. 


The angle may be specified by a 
number, a variable, or an expression. 
Real values are converted to integers, 
which must be in the range 0-255. 


RUN 


Token 172 


Class 


System and Utility Command 


RUN 


Forms RUN 


Conditions 


Note 


RUN line number 


Clears all variables, internal pointers, 
and stacks, and commences program 
execution at the indicated line number, 
if present, or at the next higher one. If no 
number is given, execution starts at the 
lowest line number encountered. 


To execute a program without clearing 
variables, use GOTO or GOSUB. 


RETURN executes RUN immediately. 


Control C terminates RUN at end of 
current statement and transfers control 
to the keyboard. CONT resumes pro- 
gram execution. 


Control S suspends RUN at end of any 
statement. Any key causes it to con- 
tinue. 


In DISK BASIC RUN becomes RUN 
name plus optional parameters. 


Token 


Class 


Conditions 


Hint 


Note 


183 


System and Utility Command 


SAVE 


SAVE initiates serial output to a jack, to 
be fed to a magnetic tape recorder to 
allow the saving of the program for later 
reentry using the LOAD command. 


Recorder operation is manual. The re- 
corder must be connected, volume 
level set, and the tape running before 
the command is executed, to avoid re- 
cording errors. 


The beginning and end of data flow is 
signaled by an audible beep. 


Do not use a recorder with automatic 
level control. Level adjust is critical. 
(Record the setting that gives good re- 
sults, or use a level indicator.) 


In DISK BASIC, SAVE name plus op- 
tional parameters is used. BSAVE 
name, A-address, L-length plus op- 
tional parameters is the related com- 
mand to transfer memory to disk. 


SAVE 


Token 153 


Class Graphics and Games Command 


SCALE= 


Form SCALE = multiplier 


Conditions Sets the scale for a shape to be drawn 
by DRAW or XDRAW, by multiplying 
each vector in the shape table by the 
indicated multiplier. 


The multiplier may be a number, a vari- 
able, or an expression. Real values are 
converted to integers and must be in the 
range 0-255 inclusive. 


A multiplier of 1 gives a 1:1 scale shape 
reproduction, and of 2 gives a 2:1 scale, 
and so on up to 255:1 scale. However, 0 
gives the largest magnification, 256. 


SCALE= 


Token 215 Name Screen Color 


Class Graphics and Games Function 


SCRN( 


Form SCRN (X coordinate, Y coordinate) 


Conditions In low resolution graphics, SCRN( re- 
turns the screen color code of the point 
defined by the coordinates. 


The coordinates may be expressed by 
a number, a variable, or an expression. 
Real values are converted to integers. 
The evaluated expression must be in 
the range О to 39 inclusive for the X 
coordinate, and 0 to 47 inclusive for the 
Y coordinate to give a true return. Val- 
ues up to 47 will be accepted for the X 
coordinate, but they will return values 
related to text or to items not on the 
screen. 


In high resolution graphics, SCRN( re- 
turns the color (or character) last re- SCRN( 
corded in the low resolution graphics 
memory area. 


In the text mode, SCRN( returns half of 
the character code, for the character at 


ү spl 
(X т 1), TE 5 ) the upper half if 


the Y coordinate is odd and the lower 
half if it is even. The expression: 


CHR$(SCRN(X- 1,2*(Y—1) + 
16*SCRN(X- 1), 


2*(Y—1) +1) returns the character 
code at character position (X,Y). 


Token 210 Name Signum Function 


Class Mathematical Function 


SGN 


Form SGN(variate) 
Conditions The signum function SGN returns the 
value of —1 if the variate is negative, +1 


if it is positive, and 0 if it is zero. 


The variate may be a number, an un- 
known, or an expression. 


Signum has no meaning for string val- 
ues. 


SGN 


SHLOAD 


Token 


Class 


Conditions 


Warning 


Hint 


154 Name Load Shape Table 


Graphics and Games Command 


SHLOAD 


Loads a shape table from magnetic 
tape into memory just below HIMEM, 
which is then moved to protect the 
shape. 


In 16K or 32K systems, using SHLOAD 
may result in program or graphics loss. 


If a shape in memory is to be replaced, 
reset boundary by entering HIMEM: 
8192 before loading the new shape. 
This wipes out the old shape and saves 
memory. 


See Shape Table. 


Token 223 Name SINE Function 


Class Mathematical Function 


SIN 


Form SIN(angle) 


Conditions Returns the sine of an angle expressed 
in radians. 


The angle may be given by anumber, a 
variable, or an expression. 


SIN has no meaning for string values. 


Token 


SPC( 


Class 


Form 


Conditions 


195 Name Skip Spaces 


Editing and Format Instruction 


SPC( 


;SPC (spaces); 


A print-list instruction that introduces 
the indicated number of spaces be- 
tween the last print item (or left screen) 
and the next item. 


Spaces may be designated by a num- 
ber, a variable, or an expression. Real 
values are converted to integers. The 


number of spaces must be between 0 
and 255 inclusive. 


The instruction may be repeated. 


Use of punctuation follows print-list 
rules. 


SPC must be in a print list. 


See PRINT. 


Token 


Class 


Form 


Conditions 


169 


Editing and Format Command 


SPEED= 


SPEED = rate 


Sets the rate at which characters are 
sent to the screen or to another output 
device. 


The rate may be a number, a variable, 
or an expression. Real values are con- 
verted to integers, which must be in the 
range 0-255 inclusive. 


0 corresponds to about two characters 
per second, 255 gives about 50 per 
second. 


SQR 


Token 


Class 


Form 


Conditions 


218 Name Square Root 
Mathematical Function 
SQR (variate) 


Returns the positive square root of the 
variate. 


The variate may be a number, a vari- 
able, or an expression. 


Negative values produce an error. 


SQR has no meaning for string vari- 
ables. 


SQR executes faster than the equiva- 
lent XA 0.5. 


Token 


Class 


Form 


Conditions 


199 


Flow of Control Instruction 


STEP 


FOR variate = initial value TO limit 
STEP increment 


Sets the value of the increment for each 
passage through a FOR-NEXT loop. 


The increment may be a number, a 
variable, or an expression. 


The increments do not need to be inte- 
gral values, but may be integers, as 
may the initial and limit values. The 
variate must be real. 


See FOR, TO, NEXT. 


STEP 


Token 179 


Class System and Utility Command 


STOP 


STOP 


Conditions When encountered, STOP suspends 
execution of a program at the end of the 
statement being processed. A check for 
STOP is made at the end of each 
statement during processing. Control 
returns to keyboard. Nothing is cleared. 
The line number containing the exe- 
cuted STOP is printed. 


Control C has the same effect, but 
clears some pointers and stacks. 


CONT causes execution to resume with 
the next statement. 


See CONT. 


Token 


Class 


Form 


Conditions 


Warning 


168 


Array and String Command 


STORE 


STORE array-name 


Used to record the values of the com- 
ponents of an array on magnetic tape. 


The array-name designates the source 
of the data. It is not recorded on tape. 


Only real and integer arrays can be 
stored. String arrays must be converted 
using the ASC function. 


Tape operation is manual. The recorder 
must be properly set and running before 
the command is executed to avoid 
error. A beep signals the start and end 
of actual transmission. 


STORE can be interrupted only by 
reset. 


See RECALL. 


While useful in systems having no disk, 
care is necessary. See the instruction 
book. 


STORE 


Token 228 Мате String Convert Function 


Class String and Array Function 


STR$ 


Form STRS$(value) 


Conditions Converts a value into a string. 


STR$ 


The value may be a number, an un- 
known, or an expression, and may be 
real or integer. 


STRS has no meaning for string quan- 
tities. 


Token 


Class 


Form 


Conditions 


192 Name Tabular Function 


Editing and Format Command 


TAB( 


TAB (spaces) 


An element of a print list, usable only in 
print lists. 


Moves the print position to the indicated 
number of spaces from the left margin if 
the number of spaces is greater than 
the present position; otherwise it does 
nothing. (Use HTAB if left movement is 
needed.) 


Spaces may be designated by a num- 
ber, a variable, or an expression. Real 
values must be converted to integers, 
which must be in the range 0-255 inclu- 
sive. 0 gives 256 spaces. 


TAB( 


Token 224 Name Tangent Function 


Class Mathematical Function 


TAN 


Form TAN(Angle) 


Conditions Returns the tangent of an angle ex- 
pressed in radians. 


The angle may be given as anumber, a 
variable, or an expression. 


TAN has no meaning for string vari- 
ables. 


Token 137 


Class 


Conditions 


Graphics and Games Command 


TEXT 


In the graphics or high resolution 
graphics modes TEXT, returns opera- 
tion to the full screen text mode of 
twenty-four lines. The prompt and cur- 
sor move to the last screen line. 


In the text mode, TEXT moves the 
prompt and cursor, (it is equivalent to 
VTAB 24). If a partial screen is set, 
TEXT resets it to full screen. 


TEXT 


Token 


Class 


Forms 


Conditions 
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Flow of Control Instruction 


THEN 


IF condition THEN instruction 
IF condition THEN GO TO line number 
IF condition THEN line number 


Basically, the second part of an IF 
THEN test, establishing the instruction 
or line number to be executed if the 
condition is satisfied. 


Either THEN or GOTO can be omitted 
in the compound statement form. 


See IF, GOTO. 


Token 


Class 


Forms 


Conditions 
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Graphics and Games 


TO 


HPLOT TO X, Y 


HPLOT TOX,, Y, TOR, Y, TOX, Y, ... 


As part of a HPLOT instruction, TO is 
used to terminate a line at the indicated 
X, Y coordinate. TO can be followed by 
one or more coordinates continuing the 
line from the last point plotted to the new 
X, Y coordinate, and so on. TO 


See HPLOT. 


As part of a FOR-NEXT loop, TO estab- 
lishes the limit value of the loop. 


See FOR, NEXT. 


TRACE 


Token 


Class 


Conditions 


Hint 
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System and Utility Command 


TRACE 


A debug aid, which displays the line 
number (preceded by #) on the screen 
each time a statement is executed. The 
number may be overwritten by PLOT 
Commands. 


Continues until NO TRACE or Control B 
is given. 


TRACE is especially useful when a 
conditional branch does not appear to 
be working as expected. 


Form 


Conditions 


Note 


213 Name User Function 


System and Utility Function 


USR 


USR (argument) 


This function passes an argument to a 
machine language subroutine. 


The argument may be anumber, a vari- 
able, or an expression, which eval- 
uated and the result placed in the float- 
ing point accumulator (address $9D 
through $A3). 


Address $0A through $0C must contain 
a machine language Jump (JMP, Low 
Byte, High Byte of address) to the 
starting address of the routine. 


The result of the routine is placed on the 
floating point accumulator at execution 
of the required RTS, which ends the 
routine. 


Use the monitor (CALL-151) to load the 
routine(s) and calling item(s). This can 
be done using POKE commands also. 


VAL 


Token 


Class 


Form 


Conditions 


229 Name String Value Function 


Array and String 


VAL 


VAL (string value) 


This function makes a numerical evalu- 
ation of a string. The first character 
must be a possible number item 
(Space, d.p., +, -, Е ого - 9), ога0іѕ 
returned. Subsequent possible number 
items are returned, until a nonnumber 
item is encountered. It and all sub- 
sequent characters are ignored. 


The string value may be a string, a 
string variable, or a string expression. If 
it is a string, it must be enclosed in 
quotes. 


Token 


Class 


Form 


Conditions 


143 Name Draw Vertical Line 


Graphics and Games 


VLIN 


VLIN Start-Y, End-Y AT X 


In low resolution graphics, VLIN draws 
a vertical line from the line designated 
as Start-Y to the line designated as 
End-Y, and located at the column de- 
signated as X. The color is that set by 
the most recent COLOR statement; that 
is, it must follow COLOR= —____. 


The positions may be given by num- 
bers, variables, or expressions. Y val- 
ues must be in the range O - 47 inclu- 
sive, and the X value in the range 0 - 39 
inclusive. 


Inthe TEXT mode, or with graphics plus 
text for lines 40 - 47 inclusive, the line 
becomes a line of characters. 


There is no visible effect in high resolu- 
tion graphics. 


See HLIN, AT. 


VLIN 


VTAB 


Token 


Class 


Form 


Conditions 


162 Name Cursor Tabulate 


Editing and Format Instruction 


VTAB 


VTAB line 


Moves the cursor to the specified line. 
Positions are relative to the top of the 
screen, and must be in the range 1-24 
inclusive. (Action is independent of the 
text window, so printing may not appear 
on the screen.) 


The line may be specified by a number, 
a variable, or by an expression. Real 
values are converted to integers. 


See HTAB. 


Token 


Class 


Form 


Conditions 
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System and Utility Instruction 


WAIT 


WAIT address, Condition, Test-on 


Used to insert a pause of controlled du- 
ration into a program. 


The address is the decimal address of a 
location whose contents is to be tested. 


The condition is a numerical value 
0-255 inclusive, which specifies the bits 
to be tested. 


The test-on value may be from 0 to 255 
inclusive. Effectively, this indicates 
whether the test for each bit is to be 
made for 1s or Os. If neither is specified, 
Os are assumed. 


The test is made by the AND of the 
location content and the Condition. If 
any one of the bits matches (1s or Os), 
the AND result becomes nonzero, and 
the wait is over. 


The parameters may be numbers, vari- 
ables, or expressions, and are con- 
verted to integer values. 


WAIT 


XDRAW 


Token 


Class 


Form 


Conditions 


149 Name Complement-draw 


Graphics and Games 


XDRAW 


XDRAW shape number AT X-coor- 
dinate, Y-coordinate XDRAW shape 
number. 


Identical in construction to DRAW, but 
draws the shape in the complement to 
the color specified by the most recent 
HCOLOR command. 


It's primary purpose is to provide a way 
to erase a shape (DRAW 3 followed by 
XDRAW 3 draws then erases the 
Shape 3, leaving only the specified 
background). 


See DRAW, AT. 


Token Not given Name Not given 


Class 


XPLOT 


Condition XPLOT is a reserved word not currently 
used. 


XPLOT 


Appendix A 
Variables 


There are three types of variables—integer, 
(range+/—32767), real, (range +/—9.99998999 
E+37) and string (0 to 255 characters). 


Variables are created by naming them in an INPUT, 
LET, or DIM statement (LET is optional), or by 
encounter in a program. 


Variable names can be a single letter, two letters, or 
a letter followed by a number, for a total of 936 
possible simple variables. 


Assigned names can be longer than two charac- 
ters, but only the first two characters are used by 
BASIC (APPLESOFT=APPLE=AP as a name). 
Remaining characters are ignored unless they in- 
clude a reserved word, which produces an error 
signal and a halt. (SING and SINGE are examples.) 
Names may not include key words. 


If the name is followed by %, it indicates an integer 
variable, and if by $, it indicates a string variable. X, 
X%, and Х$ are different variables. 

Variables used as counters with FOR must be real. 


A variable name followed by a number or numbers 
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in parentheses (subscripts) indicates an array vari- 
able. The array dimension is equal to the number of 
subscripts, which must be separated by commas, 
(maximum of 88 dimensions). Each subscript can 
vary from 0 to the number assigned in the DIM 
statement. If DIM is not used, the maximum sub- 
script value is assumed to be ten. (However, string 
arrays can have up to 255 characters per element.) 


Array names are independent of simple names 


(A(6)#A). 


Two arrays of different dimensions but with the 
same name are not allowed. 


Appendix B 
Delimiters, Operators, and Priorities 


Delimiters 

~ A А 

> › 
= < : 
= / ( 
+ * ) 

Arithmetic Operators 

+ / 
= ^ 


Logical Operators 
AND > >< <= 


OR < >= =< 
= es =e 


Unary Operators 


Expression Evaluation Priority 


Highest ( ) 
+,—, NOT (unary operators) 
^ (exponentiation) 
mi 
T, (binary operators) 
> ,<,>=, <=, =<, <> ,>< = 
АМО 
OR 


Note: In the above, commas are separators only. 
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Appendix C 


Control Character Usage 


Control B = 


Control C = 


Control D = 


Control X = 


Select integer or full BASIC, de- 
pending on firmware setting. 


Stop execution. (Also transfers from 
monitor to full BASIC.) 


Use in DOS to transfer control from a 
BASIC line to DOS, for LOAD name 
and so on. See the DOS Manual. 


(immediate mode) Enter a back 
spash and ignore line. A null re- 
sponse to INPUT. Will interrupt LIST, 
RUN execution, or INPUT if it is the 
first character. 


Escape S = Stop listing. If repeated, resume list- 


ing. 


Escape | = Move cursor E 


Escape J = Move cursor +- 


Escape К = Move cursor > 


Escape M = 


Move cursor y 


Escape F = Clear from cursor to end of screen. 
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Escape e = НОМЕ (clear screen, cursor upper 
left) 


Control U = ~ 
Control Н =< 
Control G — Bell 


Control S — Stop Listing and Program execution. 
Any key resumes execution. 


In monitor mode: 
Control U = Space 
Control H — Backspace 
Control K — Line feed 


Control M =Jump to memory read routine. 
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Appendix D 
DOS Commands 


APPEND f { } SAVE f { } 
BLOAD f, [Аа], {} UNLOCK f V 
BRUN f [, Aa] {} VERIFY f { 


BSAVE f , Аа, Lj {} WRITE f [,Rr] [,Bb] 
CATALOG [,Ss] [,Dd] Notation 


CHAIN f { } f-file name 
CLOSE [f] { | g-another file name 
DELETE f { ! s-slot number 1-6 
EXEC f [,Rp] { } v-volume number of a diskette T 
FP { } d-drive no. 1-2 
INIT f { } p-position no. 
INT r-record no. 
a-address in RAM 
IN#s b-byte no. 
LOAD +} } j-length specifier 
LOCK f { | n-number of files to be active 
MAXFILES n at one time 
MON [4] [4] [e] [ ] = optional 


NOMON [<] [4] [e] CAPS required indicator 
OPEN f [,Lj] { } 


PR#s {} 1,85] [Dd] [Vv] 
POSITION f ,Rp 

READ f [,Rr] [,Bb] -display commands 
RENAME f,g { } -display inputs 


RUN f { } -display outputs 
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Appendix E 
Color Codes and Designators 
Codes and Designators for COLOR 


Code Designator 
0 BLAK 
1 MGTA 
2 DBLU 
3 PURP 
4 DGRN 
5 GREY 
6 MBLU 
7 LBLU 
8 BRWN 
9 ORNG 
10 GREY 
11 PINK 
12 LGRN 
13 YELO 
14 AQUA 
15 WITE 


Name 
Black 
Magenta 
Dark Blue 
Purple 
Dark Green 
Grey 
Medium Blue 
Light Blue 
Brown 
Orange 
Grey 
Pink 
Green 
Yellow 
Aqua 
White 


Codes and Designators for HCOLOR 


0 black 1 
1 

2 blue 

3 white 1 
4 black 2 
5 

6 

А 


white 2 


green (depends on TV) 
(depends on TV) 


(depends on TV) 
(depends on TV) 
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Appendix F 
Memory Saving Hints 


Delete all REM statements. 

Use multiple statements per line (but watch entry 
jumps). 

Use integer arrays if possible. 

Use variables instead of constants. 

The terminal END is not necessary. 

Reuse variables. This is usually easy for counters. 

Use the zero elements of arrays. 

Use GOSUB for functions to be performed two or 
more times. 

If variables are reassigned, the old variable can be 
cleared by FRE (0). 
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Appendix G 
Useful Internal 


Routines Available as Calls 


CALL-151 


CALL-868 


CALL-922 


CALL-912 


CALL-1994 : 


CALL-1998 : 


CALL 62450: 


CALL 62454: 


CALL-936 


CALL 65385: Places computer in 
monitor mode, indicated by *. 


: Clears the current line from cur- 


sors to right margin. Same as Es- 
cape E. 


: Issues a line feed. Same as Con- 


trol J. 


: Scrolls text up one line. The top 


line is lost and the bottom becomes 
blank (for lines in the text window). 
Normally sets the upper 20 lines of 
text Page 1 to@. In Page 1 low res- 
olution graphics, it clears the upper. 
40 lines to black. It has no effect 
on Page 2 or high resolution graph- 
ics. 

Normally clears text Page 1 to re- 
versed@. In Page 1 low resolution 
full page graphics, it clears screen 
to black. It has no effect on Page 2 
or high resolution graphics. 
Clears current high resolution 
screen to black. 

Sets current high resolution screen 
to the HCOLOR most recently used 
by HPLOT. 

CALL 64600 : Moves cursor to up- 
per left screen within scrolling po- 
sition and clears all text within win- 
dow. It is identical to HOME and 
Escape @ return. 
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Appendix H 
Shape Table 


A shape table is a set of bytes that define 
vectors and plotting points. Each byte has the form: 
mmpmmpmm 
which is evaluated from right to left. The mm indi- 
cates plot position moves, one screen call at atime, 
as follows: 


mm — 00 Move up 
01 Move right 
10 Move down 
11 Move left 


and the p indicates the plot instruction, as follows: 


р= 0 Dont plot 
1 Plot 


subject to the rules 


—lf all remaining bits are zero, ignore all re- 
maining bits. 

—lf all bits are zero, the shape definition is 
complete. Each byte can thus contain a 
maximum of two plot points, and one move 
(not up). 

—The starting point is the coordinate given by 
DRAW and XDRAW. The scale is set by 
SCALE, and the orientation of “up” by ROT. 

—Hint: Graph paper and eight column "finan- 
cial" paper are a necessity for fast shape 
generation, as is practice. 
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